home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / DISKUTIL / DISKCOPY / _files / _diskclon / clonedoc next >
Text File  |  1991-07-02  |  9KB  |  189 lines
  1.                   Documentation for Disk Cloner Module V1.02
  2.                   ------------------------------------------
  3.  
  4. ********************** Incredibly boring Copyright Notice *********************
  5. *                                                                             *
  6. *      All program code is the exclusive copyright of Richard K. Lloyd.       *
  7. *     The program and documentation for Disk Cloner are freely distributable  *
  8. *            and should not be charged for under ANY circumstances.           *
  9. *                                                                             *
  10. *******************************************************************************
  11.  
  12. Installing Disk Cloner
  13. ----------------------
  14.  
  15. The Disk Cloner is installed by typing *DiskCloner. There, now that wasn't
  16. difficult was it ? If you get a 'No room in RMA' error, then type *GOS and
  17. try again.
  18.  
  19. So what does Disk Cloner do ?
  20. -----------------------------
  21.  
  22. *Help DiskCloner will reveal a little about what the program does. It copies
  23. EVERY error-free sector of an ADFS disk from one floppy to another, including
  24. the unused area of the disk.
  25.  
  26. So why use Disk Cloner rather than *BACKUP ?
  27. --------------------------------------------
  28.  
  29. For normal work/data disks, I would stick to *BACKUP. However, if you
  30. accidentally delete a file that was at the end of the floppy and you want to
  31. make a backup before you try to recover the file, then *BACKUP may not do
  32. the job, whereas Disk Cloner will. Disks corrupted mid-way cannot be fully
  33. backed up by *BACKUP, but Disk Cloner will manage to do so.
  34.  
  35.    Of course, the more unscrupulous among you will have worked out that
  36. many commercial software protection systems employ the fact that *BACKUP must
  37. check the free space map (hence the 'Bad FS Map' on some commercial disks)
  38. and that it only backs up the used section of the disk (data is therefore
  39. secreted in the 'unused' area of the disk to fool *BACKUP).
  40.  
  41.    Version 1.02 now retries bad tracks that V1.01 used to skip over. Each
  42. sector in the faulty track is individually re-read and any that are OK will
  43. be salvaged in the write pass. Faulty sectors are marked with a ?.
  44.  
  45.    Anyone can 'misuse' Disk Cloner and use it to backup much of the less
  46. well protected commercial disks. The author of Disk Cloner assumes no
  47. responsibilty for misuse in this way - and you deserve to go to jail if you
  48. sell pirated software.
  49.  
  50. The *Clone command
  51. ------------------
  52.  
  53. Syntax: *Clone <source drive> <dest. drive> [D|E|L]
  54.  
  55. The only Disk Cloner command implemented so far is *Clone, which copies an
  56. ENTIRE ADFS disk (unused space included) from the specified source drive to
  57. the destination drive indicated. You may not specify a non-existent drive
  58. (the *Configure Floppies setting is read to check this).
  59.  
  60. The optional parameter specifies the disk format type to be used. These are:
  61.  
  62. D to indicate contiguous file 800K ADFS disks (default if omitted).
  63. E to indicate non-contiguous file ('Extended') file 800K ADFS disks.
  64. L to indicate Master 640K ADFS disks.
  65.  
  66. Please note that Extended format is only available in RISC OS.
  67.  
  68. If the source drive contains an unformatted disk (Disk Cloner assumes that
  69. unformatted means 'unable to seek to track 0') then the command is aborted.
  70. However, if the DESTINATION drive holds an unformatted disk, then the first
  71. read pass is performed on the source drive and Disk Cloner then asks if you
  72. wish to format the destination disk. If you press Y (twice - because the OS
  73. format also asks for confirmation), then the disk is formatted to the type
  74. specified in the *Clone command (i.e. D, E or L...with D being the default).
  75. The first write pass then starts and the cloning continues as usual.
  76.  
  77. Application workspace from &8000 onwards is used during the copy, so you
  78. are asked for confirmation before the operation starts. Intelligent memory
  79. checks are made, so single-floppy A440's can copy a disk with only one swap.
  80. V1.02 has improved memory management to cope with the new bad track retry
  81. system.
  82.  
  83. ESCAPE may be pressed AT ANY TIME to abort the command - this is highly
  84. useful if you mess things up !
  85.  
  86. If the source drive is the same as the destination drive, then you will be
  87. prompted for a keypress to allow the disk to be swapped.
  88.  
  89. Disk Cloner Event Table
  90. -----------------------
  91.  
  92. The following is a table of what happens with different combinations of disks
  93. when using Disk Cloner.
  94.  
  95. +-------------------------+-------------------------+------------------------+
  96. | Source Disk             | Destination Disk        | Event                  |
  97. +-------------------------+-------------------------+------------------------+
  98. | Error-free 800K (D)     | Error-free 800K (E)     | OK, converts E to D    |
  99. | Error-free 800K (E)     | Error-free 800K (D)     | OK, converts D to E    |
  100. | Error-free 800K (D|E)   | Error-free 640K (L)     | Errors, unusable       |
  101. | Error-free 640K (L)     | Error-free 800K (D|E)   | OK, unusable           |
  102. | Faulty     800K (D|E)   | Error-free 800K (D|E)   | Errors, mostly usable  |
  103. | Faulty     800K (D|E)   | Faulty     800K (D|E)   | Errors, hardly usable  |
  104. | Empty drive             | Any disk or empty drive | Aborts immediately     |
  105. | Unformatted disk        | Any disk or empty drive | Aborts immediately     |
  106. | Any formatted disk      | Empty drive             | Tries+fails to format  |
  107. | Any formatted disk      | Write-protected disk    | 800 (or 640) errors !  |
  108. | Any formatted disk      | Unformatted disk        | Formats+continues      |
  109. +-------------------------+-------------------------+------------------------+
  110. Please note : Because I do not have RISC OS, I have assumed that the first two
  111. events in the table above are true...they may not be !
  112.  
  113. Revision History of Disk Cloner
  114. -------------------------------
  115.  
  116. Version 1.02
  117. ------------
  118.  
  119. * Each sector in a bad track is now retried and salvaged if OK.
  120.  
  121. * Memory management improved so less swaps are required if you have a disk
  122.   with many faulty tracks.
  123.  
  124. * If the destination disk is unformatted, Disk Cloner will allow the disk to
  125.   be formatted and then it continues the cloning where it was stopped.
  126.  
  127. * Disk Cloner now never 'hangs' - it can take a long time to report track
  128.   errors in certain circumstances though (this is what the ESCAPE key's for,
  129.   folks !) - especially if you try to dupe it by putting an unformatted disk
  130.   in the destination drive half-way through a disk clone...now you wouldn't
  131.   go and do a nasty thing like that would you ?
  132.  
  133. * If you get between 1 and 9 errors, the completion message now omits the
  134.   leading zero (not exactly awe-inspiring, but every little helps).
  135.  
  136. * All occurrences of the word 'disc' have been changed to 'disk'. This is just
  137.   for the sake of being consistent, but isn't funny that all my floppies are
  138.   labelled 'disks' and yet Acorn insist on calling them 'discs' ?
  139.  
  140. Version 1.01
  141. ------------
  142.  
  143. * Added D,E and L options even though I don't have RISC OS and can't test
  144.   the Extended format...
  145.  
  146. * Disk size is now displayed at the confirmation prompt just to reassure
  147.   jittery users.
  148.  
  149. * Added bad track checking during the read and write passes. Any track that
  150.   is not read during the read pass is skipped during the write pass without
  151.   any attempt to write data to that track.
  152.  
  153. * Now displays the total number of errors encountered - this is the sum of
  154.   the read errors AND the write errors.
  155.  
  156. * Still hangs on unformatted disks, but doesn't if the drive is empty or the
  157.   disk is write-protected or formatted to the wrong size. *FIXED IN V1.02*
  158.  
  159. Version 1.00
  160. ------------
  161.  
  162. * Written as a 1.5K module so that multiple disk cloning is trivial.
  163.  
  164. * Has a nasty tendency to fatally hang if the destination drive is either
  165.   empty or contains a write-protected disk. *FIXED IN V1.02*
  166.  
  167. * Checks memory intelligently so that swaps are minimised for single-drive
  168.   machines.
  169.  
  170. Future Improvements to Disk Cloner V1.02
  171. ----------------------------------------
  172.  
  173. * Check for non-standard sector sizes or densities.
  174.   NOTE : Please don't beg me to put this feature in. It DEFINITELY encourages
  175.   piracy and I find it more fun to crack disks by going through the code with
  176.   a disassembler (also means I can run the software from hard disk...).
  177.  
  178. Where to find me to report bugs or improvements to the Disk Cloner
  179. ------------------------------------------------------------------  
  180.  
  181. Snail Mail           JANET e-mail
  182. ----------           ------------
  183. Richard K. Lloyd,    rkl@uk.ac.liv.cs.mva
  184. 1, Banks Road,
  185. Lower Heswall,
  186. Wirral,
  187. Merseyside. 
  188.  
  189.